home *** CD-ROM | disk | FTP | other *** search
/ Clickx 115 / Clickx 115.iso / software / tools / windows / tails-i386-0.16.iso / live / filesystem.squashfs / usr / share / doc / libnet-dbus-glib-perl / README < prev   
Encoding:
Text File  |  2008-01-07  |  3.3 KB  |  125 lines
  1.                  Net::DBus::GLib
  2.                  ===============
  3.  
  4. Net::DBus::GLib provides a Perl XS API to the dbus glib bindings.
  5. Currently it performs integration with the glib main loop context.
  6. For more information on dbus visit the project website at:
  7.  
  8.   http://www.freedesktop.org/software/dbus/
  9.  
  10. This version operates against DBus 0.33, through 1.1.2 and 
  11. probably later versions, if there have been no serious API 
  12. changes. It works against dbus-glib 033, through 0.73 and
  13. probably later versions.
  14.  
  15. INSTALLATION
  16. ------------
  17.  
  18. To install this module type the following:
  19.  
  20.    perl Makefile.PL
  21.    make
  22.    make test
  23.    sudo make install
  24.  
  25. The makefile calls the C<pkg-config> script to determine the
  26. correct flags to pass to the compiler & linkers when building
  27. the XS part of the module. Thus, ensure pkg-config is in
  28. a directory listed by the $PATH environment. 
  29.  
  30. The pkg-config program will likely find the DBus install in /usr
  31. provided by the base OS distribution, so if testing against an 
  32. alternate  install of DBus, set the $PKG_CONFIG_PATH env 
  33. variable before generating the Makefile. For example, if your 
  34. dbus installation is in C<$HOME/usr/dbus-cvs-tip> , then to build
  35. and install against this version of DBus do
  36.  
  37.    export PKG_CONFIG_PATH=$HOME/usr/dbus-cvs-tip/lib/pkg-config
  38.    perl Makefile.PL PREFIX=$HOME/usr/dbus-cvs-tip
  39.    make
  40.    make test
  41.    make install
  42.  
  43.  
  44. DEPENDENCIES
  45. ------------
  46.  
  47. This module requires the following:
  48.  
  49.   Net::DBus
  50.   Glib
  51.   dbus-glib
  52.  
  53. And to run the test suite:
  54.  
  55.   Test::More
  56.   Test::Pod (optional, but recommended)
  57.   Test::Pod::Coverage (optional, but recommended)
  58.  
  59. Although they are not part of the base Perl distribution, most 
  60. OS distributor will already provide addon packages containing
  61. these modules. Failing this, they are all available from CPAN
  62. http://search.cpan.org/
  63.  
  64. EXAMPLES
  65. --------
  66.  
  67. There are a number of example programs in the examples/
  68. subdirectory demonstrating use of the high level application
  69. developer APIs.
  70.  
  71.   example-service.pl         - Providing a simple service
  72.   example-client.pl          - Talking to a remote service
  73.  
  74. CONTRIBUTIONS
  75. -------------
  76.  
  77. Contributions both simple bug fixes & new features are
  78. always welcome. Please supply patches in context, or
  79. unified diff format. A simple method to generate such a
  80. patch is as follows:
  81.  
  82.   * Clean out generated files from your working
  83.     directory:
  84.  
  85.         make distclean
  86.  
  87.   * Rename your working directory to have '-new'
  88.     extension:
  89.  
  90.         mv Net-DBus-GLib-0.33.0 Net-DBus-GLib-0.33.0-new
  91.  
  92.   * Extract a pristine copy of the source:
  93.  
  94.         gunzip -c Net-DBus-GLib-0.33.0.tar.gz | tar xf -
  95.         mv Net-DBus-GLib-0.33.0 Net-DBus-GLib-0.33.0-orig
  96.  
  97.   * Generate the patch:
  98.  
  99.         diff -ruNp Net-DBus-GLib-0.33.0-orig Net-DBus-GLib-0.33.0-new \
  100.           > Net-DBus-GLib-0.33.0-[something].patch
  101.         gzip Net-DBus-GLib-0.33.0-[something].patch
  102.  
  103.  
  104. Send the resulting to .patch.gz file directly to 
  105. Daniel Berrange <dan at berrange dot com>
  106.  
  107. Copyright (C) 2006-2008 Daniel Berrange
  108.  
  109. Net-DBus-GLib may be redistributed and/or modified under the terms of Perl itself.
  110. Either:
  111.  
  112. a) the GNU General Public License as published by the Free
  113.    Software Foundation; either version 2, or (at your option) any
  114.    later version
  115.  
  116. or
  117.  
  118. b) the "Artistic License"
  119.  
  120.  
  121. See the LICENSE file for further information
  122.  
  123. -- End
  124.  
  125.